<para>Baimena ematen da dokumentu hau kopiatu, banatu eta/edo aldatzeko Free Software Foundation-ek argitaratutako GNU Dokumentazio Librearen Lizentziaren 1.1. bertsioan edo berriago batean ezarritako baldintzetan, atal aldaezinik gabe, aurreko azaleko testurik gabe eta atzeko azaleko testurik gabe. GFDL lizentziaren kopia <ulink type="help" url="ghelp:fdl">esteka honetan</ulink> edo eskuliburu honekin batera ematen den COPYING-DOCS fitxategian aurkituko duzu.</para>
<para>Eskuliburu hau GFDL lizentziarekin banatzen diren GNOME eskuliburuen bildumakoa da. Eskuliburu hau bildumatik bereizita banatu nahi baduzu, banatu dezakezu, baina eskuliburuari lizentziaren kopia bat gehitu beharko diozu, lizentzian bertan 6. atalean azaltzen den bezala.</para>
<para>Enpresek beren produktuak eta zerbitzuak bereizteko erabiltzen dituzten izen asko marka erregistratu gisa hartu behar dira. Izen horiek GNOMEren edozein agiritan agertzen direnean, eta GNOMEren Dokumentazio Proiektuko kideak marka komertzialak direla konturatzen direnean, izen horiek osorik maiuskulaz edo hasierako letra maiuskulaz idatzi dituzte.</para>
<para>DOKUMENTUA ETA DOKUMENTUAREN BERTSIO ALDATUAK GNU DOKUMENTAZIO LIBREAREN LIZENTZIAREN BALDINTZEN ARABERA EMATEN DIRA, ETA ONDOREN ZEHAZTEN DIRENAK ONARTZERA BEHARTZEN DUTE: <orderedlist>
<listitem>
<para>DOKUMENTUA "DAGOEN-DAGOENEAN" EMATEN DA, INOLAKO BERMERIK GABE, EZ ESPRESUKI ADIERAZITAKORIK ETA EZ INPLIZITURIK ERE; BESTEAK BESTE, EZ DA BERMATZEN DOKUMENTUA EDO BERTSIO ALDATUA AKATSIK GABEA DENIK, MERKATURATZEKO EDO XEDE JAKIN BATERAKO EGOKIA DENIK EDO ARAURIK HAUSTEN EZ DUENIK, HORI GUZTIA MUGARIK GABE. DOKUMENTUAREN EDO DOKUMENTUAREN BERTSIO ALDATUAREN KALITATEARI, ZEHAZTASUNARI ETA PERFORMANTZIARI BURUZKO ERANTZUKIZUN OSOA ZUREA DA. DOKUMENTUREN BATEK EDO BERTSIO ALDATUREN BATEK EDOZEIN MOTATAKO AKATSIK IZANEZ GERO, ZUK (EZ HASIERAKO IDAZLEAK, EZ EGILEAK ETA EZ INONGO KOLABORATZAILEK) ZEURE GAIN HARTU BEHARKO DUZU BERRIKUSTEKO, KONPONTZEKO EDO ZUZENTZEKO BEHAR DIREN ZERBITZU GUZTIEN KOSTUA. BERME-UKATZE HAU LIZENTZIA HONEN FUNTSEZKO ZATIA DA. EZ DA BAIMENIK EMATEN EZEIN DOKUMENTU EDO BERTSIO ALDATU ERABILTZEKO, BALDIN ETA EZ BADA BERME-UKATZE HAU ONARTZEN.</para>
</listitem>
<listitem>
<para>EZIN IZANGO DA INONGO ZIRKUNSTANTZIARIK EDO LEGE-TEORIARIK OINARRI HARTU --EZ ERANTZUKIZUN ZIBILARI BURUZKORIK (ZABARKERIA BARNE HARTUTA), EZ KONTRATUARI BURUZKORIK, EZ BESTERIK-- DOKUMENTU HONEN EDO BERTSIO ALDATU BATEN EGILEA, HASIERAKO IDAZLEA, EDOZEIN KOLABORATZAILE EDO BANATZAILE, EDO ALDERDI HORIEN EDOZEIN HORNITZAILE BESTE PERTSONA BATEN AURREAN ERANTZULE EGITEKO, PERTSONA HORREK EDOZEIN MOTATAKO KALTEA JASAN DUELAKO (ZUZENEKOA, ZEHARKAKOA, BEREZIA, INTZIDENTALA EDO ONDORIOZKOA), HALA NOLA (ETA MUGARIK GABE) BEZEROAK GALTZEA, LANA ETEN BEHARRA, ORDENAGAILUAK EZ IBILTZEA EDO GAIZKI IBILTZEA, EDO DOKUMENTUA NAHIZ HAREN BERTSIO ALDATUAK ERABILTZETIK ONDORIOZTATZEN DIREN EDO ERABILERA HORREKIN ZERIKUSIA DUTEN KALTEAK EDO GALERAK, ALDERDIARI KALTE HORIEK GERTA ZITEZKEELA ADITZERA EMAN BAZAIO ERE.</para>
<!-- Translators may also add here feedback address for translations -->
</legalnotice>
<abstract role="description">
<para>Gdialog-en berridazketa da Zenity, hau da, GNOMEren dialog-en bertsioa; komando-lerrotik eta shell script-etik elkarrizketa-koadroak bistaratzeko aukera ematen dizu.</para>
<para>Script-ak idazterakoan, <application>Zenity</application> erabil dezakezu erabiltzaileari grafikoki eragiten dioten elkarrizketa-koadro sinpleak sortzeko.</para>
<itemizedlist>
<listitem>
<para>Erabiltzaileagandik informazioa lortzeko, elkarrizketa-koadro bat sor dezakezu. Esaterako, erabiltzaileari eska diezaiokezu elkarrizketa-koadroko egutegitik data bat aukeratu dezan, edo elkarrizketa-koadroko fitxategi-hautapenetik fitxategi bat hauta dezan.</para>
</listitem>
<listitem>
<para>Erabiltzaileari informazioa emateko, elkarrizketa-koadro bat sor dezakezu. Esaterako, eragiketa baten egoera adierazteko, elkarrizketa-koadroko progresio-barra erabil dezakezu, edo, erabiltzailea ohartarazteko, elkarrizketa-koadroko abisu bat.</para>
</listitem>
</itemizedlist>
<para>Erabiltzaileak elkarrizketa-koadroa ixten duenean, elkarrizketa-koadroak errore estandarrerako sortutako testua bistaratzen du <application>Zenity</application> aplikazioak.</para>
<note>
<para><application>Zenity</application>ren komandoak idaztean, segurtatu argumentu bakoitza komatxo artean jartzen duzula.</para>
<para>Adibidez, erabili: <screen><userinput><command>zenity -–calendar –title="opor-planifikatzailea"</command></userinput></screen> Ez erabili: <screen><userinput><command>zenity -–calendar –title=Opor-planifikatzailea</command></userinput></screen></para>
<para>Komatxo artean jartzen ez baduzu, ustekabeko emaitzak lortuko dituzu.</para>
</note>
<sect2 id="zenity-usage-mnemonics">
<title>Tekla bizkortzaileak</title>
<para>Teklatua erabiliz menu bateko edo elkarrizketa-koadro bateko komando bat sagua erabili gabe aukeratzeko modua eskaintzen dizu tekla bizkortzaileak. Menu edo elkarrizketa-koadroetako aukera bakoitzean azpimarratuta dagoen letra da bizkortzailea.</para>
<para><application>Zenity</application> elkarrizketa-koadroek tekla bizkortzaileen erabilera onartzen dute. Tekla bizkortzaile moduan erabiliko den karakterea zehazteko, jarri azpimarra karakterearen aurretik elkarrizketa-koadroko testuan. Adibide hauetan ikusten da nola zehaztu behar den 'C' letra tekla bizkortzaile gisa:</para>
<screen><userinput>"_Aukeratu izen bat".</userinput></screen>
</sect2>
<sect2 id="zenity-usage-exitcodes">
<title>Irteera-kodeak</title>
<para><application>Zenity</application> aplikazioak irteera-kode hauek itzultzen ditu:</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1">
<colspec colname="COLSPEC0" colwidth="50*"/>
<colspec colname="COLSPEC1" colwidth="50*"/>
<thead>
<row valign="top">
<entry colname="COLSPEC0">
<para>Irteera-kodea</para></entry>
<entry colname="COLSPEC1">
<para>Azalpena</para></entry>
</row>
</thead>
<tbody>
<row valign="top">
<entry>
<para><varname>0</varname></para>
</entry>
<entry>
<para>Erabiltzaileak <guibutton>Ados</guibutton> edo <guibutton>Itxi</guibutton> sakatu du.</para>
</entry>
</row>
<row valign="top">
<entry>
<para><varname>1</varname></para>
</entry>
<entry>
<para>Erabiltzaileak <guibutton>Utzi</guibutton> sakatu du edo leihoen funtzioak erabili ditu elkarrizketa-koadroa ixteko.</para>
</entry>
</row>
<row valign="top">
<entry>
<para><varname>-1</varname></para>
</entry>
<entry>
<para>Ustekabeko errorea gertatu da.</para>
</entry>
</row>
<row valign="top">
<entry>
<para><varname>5</varname></para>
</entry>
<entry>
<para>The dialog has been closed because the timeout has been reached.</para>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect2>
<!-- ==== General Options ====== -->
<sect2 id="zenity-usage-general-options">
<title>Aukera orokorrak</title>
<para><application>Zenity</application> aplikazioaren elkarrizketa-koadro guztiek aukera orokor hauek onartzen dituzte:</para>
<para>Elkarrizketa-koadroaren leiho-markoetan bistaratu den ikonoa zehazten du. 4 ikono daude erabilgarri gako-hitz hauek sartuz gero - 'info', 'warning', 'question' eta 'error'.</para>
<para>Aukera askotarako laguntza bistaratzen du.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--help-gtk</option></term>
<listitem>
<para>GTK aukeretarako laguntza bistaratzen du.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<!-- ==== Miscellaneous Options ====== -->
<sect2 id="zenity-miscellaneous-options">
<title>Askotariko aukerak</title>
<para><application>Zenity</application> aplikazioak askotariko laguntza-aukera hauek ere eskaintzen ditu:</para>
<variablelist>
<varlistentry>
<term><option>--about</option></term>
<listitem>
<para><guilabel>Zenity-ri buruz</guilabel> elkarrizketa-koadroa bistaratzen da eta hau aurkitu dezakezu: <application>Zenity</application> bertsioari buruzko informazioa, copyrightaren informazioa eta garatzaileen informazioa.</para>
<para><application>Zenity</application> aplikazioak GTKren aukera estandarrak onartzen ditu. GTKren aukerei buruzko informazio gehiago nahi izanez gero, exekutatu <command>zenity -?</command> komandoa.</para>
</sect2>
</sect1>
<!-- ==== Calendar Options ====== -->
<sect1 id="zenity-calendar-options">
<title>Egutegiaren elkarrizketa-koadroa</title>
<para>Erabili <option>--calendar</option> aukera, egutegiaren elkarrizketa-koadroa sortzeko. <application>Zenity</application> aplikazioak hautatutako data errore estandarrera itzultzen du. Komando-lerroan datarik zehaztu ez bada, elkarrizketa-koadroak uneko data erabiltzen du.</para>
<para>Egutegiaren elkarrizketa-koadroak aukera hauek onartzen ditu:</para>
<para>Egutegiaren elkarrizketa-koadroan hautatu den eguna zehazten du. <replaceable>eguna</replaceable>k 1 eta 31 arteko zenbaki bat izan behar du (bi horiek barne).</para>
<para>Egutegiaren elkarrizketa-koadroan hautatu den hilabetea zehazten du. <replaceable>hilabetea</replaceable>k 1 eta 12 arteko zenbaki bat izan behar du (bi horiek barne).</para>
<para>Data hautatu ondoren egutegiaren elkarrizketa-koadroak itzuli duen formatua zehazten du. Formatu lehenetsia ezarpen lokalen araberakoa da. <command>strftime</command> funtzioak <replaceable>formatua</replaceable> onartu behar du, <literal>%A %d/%m/%y</literal> esate baterako.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Script-en adibide hauek erakusten dute nola sortu egutegiaren elkarrizketa-koadroa: <programlisting>
<para>Elkarrizketa-koadroa lehenengoz erakusten denean, fitxategi-hautapenaren elkarrizketa-koadroan hautatutako fitxategia edo direktorioa zehazten du.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--multiple</option></term>
<listitem>
<para>Fitxategi-hautapenaren elkarrizketa-koadroan era askotako fitxategi-izenak hautatzeko aukera ematen du.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--directory</option></term>
<listitem>
<para>Fitxategi-hautapenaren elkarrizketa-koadroan dauden direktorioak hautatzea soilik baimentzen du.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--save</option></term>
<listitem>
<para>Fitxategi-hautapenaren elkarrizketa-koadroa gorde moduan jartzen du.</para>
<para>Erabili <option>--list</option> aukera, zerrendaren elkarrizketa-koadroa sortzeko. <application>Zenity</application> aplikazioak testuan hautatutako errenkadetako lehenengo zutabeetan dauden sarrerak errore estandarrera itzultzen ditu.</para>
<para>Elkarrizketa-koadroaren datuak zutabez zutabe eta errenkadaz errenkada zehaztu behar dira. Elkarrizketa-koadroak sarrera estandarraren bidez jaso ditzake datuak. Sarrera bakoitza lerro berriko karaktere batekin bereizi behar da.</para>
<para><option>--checklist</option> edo <option>--radiolist</option> aukerak erabiltzen badituzu, errenkada bakoitza 'TRUE' edo 'FALSE'-rekin hasi beharko da.</para>
<para>Zerrendaren elkarrizketa-koadroak aukera hauek onartzen ditu:</para>
<para>Elkarrizketa-koadroan bistaratzen diren zutabe-goiburuak zehazten ditu. <option>--column</option> aukera zehaztu behar duzu elkarrizketa-koadroan bistaratzea nahi duzun zutabe bakoitzarentzat.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--checklist</option></term>
<listitem>
<para>Zerrendaren elkarrizketa-koadroko lehen zutabeak kontrol-laukiak dituela adierazten du.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--radiolist</option></term>
<listitem>
<para>Zerrendaren elkarrizketa-koadroko lehen zutabeak aukera-laukiak dituela zehazten du.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--editable</option></term>
<listitem>
<para>Bistaratutako elementuak editatzeko aukera ematen du.</para>
<para>Zer zutabe inprimatu behar den zehazten du, hautapenaren arabera. Zutabe lehenetsia '1' da. Zerrendako zutabe guztiak inprimatzeko 'ALL' erabil daiteke.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Script-en adibide hauek erakusten dute nola sortu zerrendaren elkarrizketa-koadroa: <programlisting>
<para><application>Zenity</application> aplikazioak errenkadaz errenkada irakurtzen ditu sarrera estandarreko datuak. Errenkada bat aurrez #rekin finkatzen bada, testua errenkada horretako testuarekin eguneratzen da. Errenkada batek zenbaki bakar bat soilik badu, ehunekoa zenbaki horrekin eguneratzen da.</para>
<para>Progresioaren elkarrizketa-koadroak aukera hauek onartzen ditu:</para>